home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir28 / sop9435a.zip / STSPLUS.NEW < prev    next >
Text File  |  1994-08-25  |  12KB  |  210 lines

  1. STSORBIT PLUS Revision History
  2. ------------------------------
  3.  
  4.       Each released version of STSPLUS uses a four digit revision code such 
  5. as 9435. The first two digits indicate the year and the second two digits 
  6. indicate the week of the year. In some cases, an additional letter suffix 
  7. is added to distinguish changes occurring within the same week or to 
  8. identify special versions. A partial week at the beginning or end of the 
  9. year is counted as a full week. Using this method, a year will typically 
  10. have 53 weeks although it is possible to have 54 weeks in a leap year (1972 
  11. is an example). The current year-week revision code is shown on the Julian 
  12. Date display, Display Mode 7, in my program ASTROCLK.
  13.      This file records the revision history of program STSPLUS through all 
  14. of the minor twists and turns that usually accompany the evolution of such 
  15. a complex program. It illustrates the tortuous process of maintaining and 
  16. refining a program as ideas and problems are reported from every quarter. 
  17. These notes may also be helpful to users who are upgrading from one version 
  18. to another to find out what has changed.
  19.  
  20.                                               David H. Ransom, Jr.
  21.  
  22.  
  23. Version 9435A -- August 1994
  24. ----------------------------
  25. -Version 9435A corrects a problem with certain country codes (such as those 
  26. which use the "YY-MM-DD" date format) which still caused "BASIC Error = 5" 
  27. in the orthographic mode for Version 9435. The program should now be 
  28. independent of the country code.
  29. -Corrected a minor bug with amateur radio satellite frequencies. If the 
  30. primary satellite was changed with F6, the frequency file (STSPLUS.FRQ) was 
  31. not rescanned and the frequencies from the prior satellite remained. 
  32. STSPLUS will now always rescan file STSPLUS.FRQ if the primary satellite is 
  33. changed.
  34.  
  35.  
  36. Version 9435 -- August 1994
  37. ---------------------------
  38. -This release repairs an unfortunate bug which surfaced when I added the
  39. NORAD-style date on the orthographic display. Only users who set DOS to
  40. non-US-style date formats were affected. The problem occurred immediately 
  41. when drawing the orthographic map as "BASIC Error = 5" and returned the 
  42. user to DOS.
  43. -Added satellite name cross-reference in file STSPLUS.XRF. When TLEs are 
  44. read and accepted, STSPLUS now checks for the cross-reference file and, if 
  45. the file is present in the current directory, checks for the NORAD Number 
  46. of the satellite and a cross-reference name. If found, the new name is 
  47. substituted for that found in the TLE file. The file is standard ASCII and 
  48. each entry consists of a SPACE, the five-digit NORAD Number, a SPACE, and 
  49. then the satellite name. A sample file:
  50.  
  51.  22920 HST Solar Array
  52.  22076 Topex/Poseidon
  53.  21225 Gamma Ray Observ
  54.  20638 Rosat Observatory
  55.  20580 Hubble Telescope
  56.  16609 MIR Space Station
  57.  
  58. NOTE: The leading space is required for file compatibility with my program 
  59. ORBITEL (but is optional for STSPLUS). The NORAD Number MUST be 5 digits; 
  60. pad with leading zeroes if necessary. Only one entry is read per satellite. 
  61. If the satellite name is longer than 19 characters, only the left 19 
  62. characters will be used. This feature may be used to substitute any name 
  63. for that given in a TLE file (which is not always consistent from source to 
  64. source) or to specify a payload piggy-backed on another satellite (as is 
  65. frequently the case with amateur radio transponders). A number of XRF files 
  66. are posted on my RPV Astronomy BBS; such files must be renamed for use with 
  67. STSPLUS.
  68. -Repaired a minor bug which caused the pass predictions (F3 from Main Menu 
  69. to repeat a pass indefinitely when that pass was a grazing pass with a 
  70. maximum elevation of less than one degree (0.14 degrees in the test case 
  71. reported by Ken Ernandes).
  72. -Corrected a bug in read/save .SCF files (F6 from the Main Menu). If a 
  73. fileltype is entered (".SCF" or whatever), it is now ignored and ".SCF" is 
  74. automatically appended to the filename. Thanks to Paul Becker for reporting 
  75. the problem.
  76. -In response to many requests, the date input routine has been modified to 
  77. permit entry in the European style "dd.mm.yyyy" in addition to the US style 
  78. "mm/dd/yyyy". The choice of delimiter ("." or "/") determines the method of 
  79. interpretation. In both cases, the year may be entered as the last two 
  80. digits only, "yy", if desired; "50" through "99" will be interpreted as 
  81. "1950" through "1999" and all others as 2000+yy. Dates are displayed as "dd 
  82. MMM yyyy" where "MMM" is the English abbreviation for the month.
  83. -All current .SCF files are now displayed for both SAVE and READ functions 
  84. (F6+F2 and F6+F3 from the Main Menu).
  85. -Improved backspace processing and error checking when entering TLE 
  86. filenames (F2 from the Main Menu).
  87. -Corrected "West Latitude" to "West Longitude" in the data entry section 
  88. for local coordinates (F10+F2).
  89. -Various minor cosmetic changes.
  90.  
  91. -Version 9434 was released as a Beta Version to selected users and included 
  92. all changes in Version 9435 EXCEPT the repair to the NORAD-style date bug.
  93.  
  94. Version 9432A -- August 1994
  95. ----------------------------
  96. -As too often happens, a bug was discovered in Version 9432 just after it 
  97. was released. The elevation ("Elv") and azimuth ("Azm") in the rectangular 
  98. projections either remained at zeroes or at the last value calculated 
  99. during orthographic projection. There was no workaround. The problem has 
  100. been repaired. My apologies to those who received the defective version.
  101.  
  102.  
  103. Version 9432 -- July 1994
  104. -------------------------
  105. -Version 9432 adds several new features and corrects a number of program 
  106. errors and/or "bugs". Several minor cosmetic changes were also made.
  107. -Added Data Output Mode 8 to generate tabular output for Doppler Shift 
  108. calculations for a selected pass while the tracking map is displayed. Use 
  109. F3 from the Main Menu and select Mode 8; setup features are identical to 
  110. other modes (output device, interval, etc.). See text for details.
  111. -Look angle calculations [elevation ("Elv") and azimuth ("Azm")] during the 
  112. tracking map display are more accurate thanks to an improved algorithm 
  113. supplied by Ken Ernandes. Users should note that near culmination (maximum 
  114. elevation) for passes near the user's zenith (approaching 90 degrees 
  115. elevation) there is some uncertainty and ambituity as to azimuth although 
  116. the angular error remains very small.
  117. -Changed "Alt" to "Elv" as the label for satellite elevation (altitude) 
  118. above mean sea level to conform to standard satellite tracking convention.
  119. -Because STSPLUS is used worldwide, I have reformatted all displayed dates 
  120. throughout the program to avoid confusion of the day versus the month. For 
  121. orthographic displays, the display now shows the current UTC date and time 
  122. ("dd MMM hh:mm:ss UTC") and then the local time ("dd mmm hh:mm:ss PDT" 
  123. where "PDT" is replaced by the local time abbreviation). For both dates, 
  124. the year is implied. The MET/T+E is moved up one line. A typical time 
  125. display will show:
  126.      15 JUL 19:57:36 UTC
  127.      15 JUL 12:57:36 PDT
  128.           7/03:14:36 MET
  129. For the Main Menu and rectangular projections, the dates are all given as 
  130. "dd MMM yyyy". Data locations are unchanged. A typical date and time will 
  131. now be displayed as:
  132.      15 JUL 1994  19:57:36 UTC
  133. For all cases, "MMM" is the three letter English abbreviation for the 
  134. month, "JAN" for January, "FEB" for February, etc.
  135.  
  136.      IMPORTANT NOTE: Keyboard entry of dates is still in the American 
  137.      numeric format, "mm/dd/yyyy" or "mm/dd/yy".
  138.  
  139. -For orthographic projections, the current time using NORAD convention 
  140. ("yyddd.dddddd") is displayed immediately beneath the current TLE filename:
  141.         94196.831667
  142. This provides an immediate method to identify the current year and day-of-
  143. the-year, "94" and "196" respectively in the example above.
  144. -Added an additional data line in orthographic display to show the current 
  145. orbital period ("Per'd" using the format "hh:mm:ss") for normal display OR, 
  146. for satellites with Eccentricity >= 0.005, satellite Phase, defined as Mean 
  147. Anomaly normalized to the range 0-256 ("Phase" using the format "nnn.n") 
  148. for use with the Doppler Shift mode [press F8 while the map is displayed] 
  149. and satellites which change transponder mode based upon phase. Although 
  150. Phase is technically defined as an integer value from 0 through 255, 
  151. STSPLUS displays it to one decimal place to alert users to upcoming 
  152. phase/transponder changes. Other users may also be interested in two 
  153. important Phase or Mean Anomaly angles: Phase=0.0 (Mean Anomaly is 0 
  154. degrees) corresponds to perigee and Phase=128.0 (Mean Anomaly is 180 
  155. degrees) corresponds to apogee.
  156.  
  157.      NOTE: Mean Anomaly (and therefore Phase) becomes undefined for a 
  158.      perfectly circular orbit. In practice, satellites with eccentricity 
  159.      less than 0.005 will display some ambiguity as to Mean Anomaly and 
  160.      Phase. Note also that the "Elv" is the geodetic elevation (altitude) 
  161.      of the satellite above Mean Sea Level and NOT the geocentric radius of 
  162.      the satellite's orbit, the paramter used to determine apogee and 
  163.      perigee; the difference due to the shape of the Earth is as much as 
  164.      21 km. See the section "Satellite Communications and Amateur Radio" 
  165.      for additional discussion!
  166.  
  167. -Repaired the Tracking Station color feature (F10+F9) so that it operates 
  168. correctly. Versions 9415/9414 caused the entire screen to turn light red 
  169. when the Tracking Station color was changed due to a careless coding error.
  170. -Rewrote the local coordinates code and text (F10+F2) to improve clarity 
  171. and add several features. Now uses a function key menu to select action to 
  172. perform. Press ENTER to return to prior menu. When entering new 
  173. coordinates, an illegal latitude or longitude will cause that coordinate to 
  174. be set to zero. Longitude may be entered as East Longitude (0 to +360) or 
  175. West Longitude (0 to -180); the longitude is converted if necessary and 
  176. stored in the range from -180 to 0 to +180.
  177. -The threshold for generating the "Satellite may have decayed!" message has 
  178. been increased to a Mean Motion of 16.4 revs/day to reduce the probability
  179. of the message appearing during low shuttle flights.
  180. -Added code to check for synchronization and data errors in the .INI file 
  181. between the "short form" satellite position data and the 2-line elements. 
  182. If the NORAD numbers do not agree, the "short form" data will be set to the 
  183. TLE NORAD number and the remaining data reset; if TLEs are not present, 
  184. dummy TLEs are inserted. Use F6 to verify and/or correct the secondary 
  185. satellites, then use F2+& to update data from TLE file(s).
  186. -Adjusted the "trigger" for automatic redraw in orthographic modes with 
  187. higher zoom factors to compensate for high speed processors such as the 
  188. 90MHz Pentium. (Under some circumstances, redraw was being triggered 
  189. continuously.)
  190. -Repaired a minor bug that caused the TDRS and Sun AOS/LOS data to be 
  191. missing on the rectangular display when Doppler Shift mode had been 
  192. selected on the orthographic display.
  193. -Corrected the conversion factor used to convert meters to feet. Thanks to 
  194. Steve Lenz for reporting the bug!
  195. -Removed all references to the RPV HOTLINE BBS since that telephone line is 
  196. now in rotary with the main number, (310) 541-7299.
  197.  
  198. -Versions 9424, 9429, and 9431 were beta test versions not released 
  199. publicly and included some of the features and changes in this release. For 
  200. Version 9424, the precision of Doppler shift frequencies was increased to 5 
  201. digits (10 Hz) to the right of the decimal point but this proved confusing 
  202. and has been restored to 4 digits (100 Hz).
  203.  
  204. Version 9415 -- April 1994
  205. --------------------------
  206. -This release repairs a problem in rectangular projections which caused the 
  207. Alt/Az calculations to be incorrect. (The data in orthographic projections 
  208. were alright.) The problem was traced to a duplicated variable name which 
  209. was added to shared common. Only file STSPLUS.EXE is changed.
  210.